home *** CD-ROM | disk | FTP | other *** search
/ Aminet 22 / Aminet 22 (1997)(GTI - Schatztruhe)[!][Dec 1997].iso / Aminet / dev / e / poolStrings.readme < prev    next >
Text File  |  1997-11-02  |  3KB  |  61 lines
  1. Short:    Allocate EStrings into memory pools 
  2. Author:   Matteo Cavalleri 2.335/633.19@fidonet
  3. Uploader: paolob@mbox.queen.it
  4. Type:     dev/e
  5. Requires: amigalib/mempools.m 
  6.  
  7.                                poolStrings 1.0
  8.                                ***************
  9.  
  10. This module can allocate an estring into a memory pool.
  11. two functions are provided:
  12.  
  13. string:=poolString(strmax, pool) - allocate an estring of 'strmax' length
  14.                                    into the 'pool' memory pool
  15.                                    (it's safe to pass null values for the
  16.                                     arguments. like the original function
  17.                                     you MUST check 'string' against NIL)
  18.  
  19. poolDisposeLink(string, pool)    - deallocate a previously allocated string.
  20.                                    you must pass the correct pair of 'string'
  21.                                    and 'pool' (It's safe to pass null values)
  22.  
  23. After you have allocated a string with poolString() you can use it as a
  24. normal estring (look at the example source).
  25. There are just two limitations:
  26.  
  27.   * If you want to deallocate a string allocated with poolString()
  28.     you MUST use poolDisposelink(), and you cannot use poolDisposelink()
  29.     on a string allocated with String()
  30.  
  31.   * You cannot link strings that are in different memory pools or strings
  32.     allocated with poolString() with strings allocated with String().
  33.  
  34. The module 'poolString.m' requires the mempools.m module (that must be
  35. placed in emodules:amigalib). Since I've found no copyrigth notice about
  36. that module I placed it in this archive. In any case the original archive
  37. can be found on aminet as dev/e/pools_m.lha
  38.  
  39. 'poolStringV39' uses directly the V39 exec function, so you don't need
  40. the mempools module, but you can run it only on V39 amigas
  41.  
  42. This module is Public Domain
  43.  
  44. For any suggestion you can write to:
  45.  
  46.     Matteo Cavalleri 2:335/633.19@fidonet
  47.                      39:102/16.19@amiganet
  48.  
  49.  
  50. ============================= Archive contents =============================
  51.  
  52. Original  Packed Ratio    Date     Time    Name
  53. -------- ------- ----- --------- --------  -------------
  54.     1982     818 58.7% 25-Sep-97 13:18:34  poolStrings.readme
  55.      832     539 35.2% 30-Aug-97 12:41:34 +mempools.m
  56.      474     304 35.8% 25-Sep-97 13:09:00 +poolStrings.m
  57.      402     265 34.0% 25-Sep-97 13:09:06 +poolStringsV39.m
  58.     1527     641 58.0% 25-Sep-97 13:14:56 +poolStrings_test.e
  59. -------- ------- ----- --------- --------
  60.     5217    2567 50.7% 27-Sep-97 15:05:26   5 files
  61.